VNC for EPOC
------------

This SIS file has been produced from a slightly modified version 
of the publicly available Java VNC client v3.3.3r2.  It installs 
directly to the apps folder, and all functionality is accessible 
from the VNC interface.

In practice the modifications are:

	- Added host and port fields to avoid the need for 
	  command line usage

	- Added a help option, to inform users how to move 
	  the small psion screens around over the larger VNC
	  display

Version 2 adds:

	- EPOC R6 is supported, unfortunately with a different SIS file.
	  This adds functionality for the R6 menus and programmable keys
	  ******************SEE INFORMATION BELOW********************

	- Removed the port field - the host field now requires an 
	  entry of <host>:<port>

	- Any port under 10 is considered to be a VNC display number,
	  (and thus has 5900 added to it to produce the real IP port)
	  Any port over 10 is treated as a real IP port number

	- Added a saved hosts list.  These reside in the file
	  \System\Apps\Vnc\vnchosts.txt and should be <host>:<port>
	  one per line.  This file must be manually edited, it is
	  not automatically updated

	- Scroll bars have been added, which means that the CTRL-SPACE
	  sequence should not be needed.  This option can be turned off 
 	  in the options page, but this causes problems on R6 as you then 
	  can't move around the full screen.


Latest version has ONLY been tested on a Psion Netbook,the Nokia 9210, and 
the Nokia 9210 EMULATOR.


Previous version has been reported as working on the Revo, 5mx and Series 7.  
It also works sucessfully on the psion emulator, as supplied with the SDK.

Remember though, it is a Java application and therefore requires the 
Java Virtual Machine to be loaded onto the psion.  This comes pre-installed
on some models, not others.  The error message obtained when running 
VNC without the JVM is something like 'information not found'

FILES IN KIT
------------

	vnc-old.sis	Version 1 of application - only works with R5
	vncR5.sis	Version 2 of application - for R5!
	vncR6.sis	Version 2 of application - for R6!
	redirect.sis	Application for use on R6 for troubleshooting
	cawt.jar	Extra jar file - may be needed on some R6 machines


TROUBLESHOOTING
----------------

1.  If you are using an R6 machine, ensure that you have the file cawt.jat 
    installed, in \ext or \classes, or in the vnc app directory

2.  The Nokia 9210 has very little memory available for applications after the 
    Java Virtual Machine has loaded (~1.9Mb).  VNC uses quite large buffers 
    for screen and colour information, and thus WILL NOT WORK with servers where 
    the display settings are hi-res and the colours are many.  It DOES work with 
    servers that have 640x480 resolution and 256 colours.  Go higher, it may not
    work.

2.  If you are using R6, try using the redirect application to direct java output
    to a file.  This will give a reason for the failure

3.  If you are using R5, java output will log to \logs\java\java.txt.  This file 
    will contain a reason for the failure

4.  Send me an e-mail!


FAQ
---

I have had questions about the port field - basically, the port is 
the tcp/ip port that the vnc server is listening on.  Vnc calls this 
a 'display number'.  Vnc display number 0 is tcp/ip port 5900, vnc display
number 1 is tcp/ip port 5901 etc.  The port field needs the tcp/ip 
port, NOT the vnc display number.  It is done this way because we 
frequently run VNC on non standard ports, and so use tcp/ip numbering 
in preference to vnc numbering.  The default port used by the standard 
vnc server installation is 5900 - so use this number unless you have 
changed the server configuration in any way.


On the 9210, the screen may be off the right hand of the Nokia display.  To 
correct, select the menu option 'No Status Panel'

INFO
-----

Any comments or questions, please e-mail me:  steve.allam@imhotek.com


REGISTER
--------

To register as a user, please send a mail to epocvnc@imhotek.com.  The 
only details I would like is what psion you are using, and your e-mail 
address.  I will *NOT* be using these details for anything other than 
letting you know of version changes, and a knowledge of what you are 
using allows me to verify that updates work on all platforms.

Note:  This kit is available on the Imhotek web-site: 

	http://www.imhotek.com/downloads/epoc_vnc.zip


LICENSE
-------

This product is based on the freely available VNC product, which can 
be downloaded from:

	http://www.uk.research.att.com

It is distributed under the GNU General Public License, which can be 
seen at:

	http://www.uk.research.att.com/vnc/gpl.html


You are free to download it, use it, and redistribute it under the terms
 of the GNU Public Licence. 
